home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / comms / thor_2.22 / thor.lha / rexx / ChessMaster3000.doc < prev    next >
Text File  |  1995-12-18  |  4KB  |  89 lines
  1. /* ChessMaster3000.thor by Troels Walsted Hansen
  2. ** $VER: ChessMaster3000.thor v1.30 (29.01.95)
  3. **
  4. ** An ARexx script for playing a game of chess against another THOR-
  5. ** user through messages on a BBS. 
  6. */
  7.  
  8. Instructions for use
  9. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  10. You need to have the main THOR window open, because the script uses the
  11. message listview for displaying the chess board. If you start the script
  12. and the current message doesn't contain a game underway, you have the
  13. option of starting a new one. Starting a new game will make you the white
  14. player and thus let you have the first move. You may choose any BBS to
  15. post the message on, any receiver, any subject, etc.
  16.  
  17. Making your move is done via a string requester asking for coordinates.
  18. Entering e.g. 'b1c3' will move your white knight from B1 to C3. The game
  19. *does* *not* check the validity of your moves under the rules of chess.
  20. It merely checks whether you're really moving one of your own pieces to
  21. a valid square.
  22.  
  23. You may also click the 'Special moves' button (leaving the string gadget
  24. empty) and be prompted with three different choices. Exchanging of pawns
  25. is probably the most common one and you may use it when one of your pawns
  26. have reached the other end of the board. It may be exchanged into either
  27. of the other pieces, except for the king of course.
  28.  
  29. To castle is the second option. This involves moving your king two steps the
  30. left (long castling) or to the right (short castling). The squares between
  31. the king and either of your castles must be open, and if they are, the castle
  32. will jump over the king and stand next to him.
  33.  
  34. The last option is the rarest (at least I had never heard of it before), it
  35. let's you beat an opponent pawn 'en passant' (in passing). One of your pawns
  36. must've been guarding the square in front of an opponent pawn, an opponent
  37. pawn which has not moved earlier in the game. Not having moved earlier gives
  38. the pawn the opportunity to walk past you by taking it's two-step first move.
  39. If it does this you may beat it, without moving your own pawn, when it is
  40. your turn. This must happen immediately after the opponent pawn jumped past
  41. your guarding pawn.
  42.  
  43. Winning the game is accomplished by actually beating the opponent's king.
  44. This is not usually done in chess, but this script has no facilities for
  45. detecting a checkmate.
  46.  
  47. After you've made your move, you will be prompted with the possibility to
  48. edit the message. This allows you to relay haughty comments to your opponent,
  49. but you must be careful not to edit below the '***ChessMaster [...]' line!
  50. Doing so might make the script unable to parse the message when your opponent
  51. is making his/hers move. Anything above the indicated line will be ignored
  52. and discarded by the script.
  53.  
  54. Other info
  55. ¯¯¯¯¯¯¯¯¯¯
  56. The chess pieces are represented as follows:
  57.  K = King      B = Bishop     C = Castle
  58.  Q = Queen     N = Knight     P = Pawn
  59.  
  60. A square with a '^'-character below it is *black*.
  61.  
  62. Black chess pieces are indicated with styletags for reverse video. If you
  63. haven't switched on Styletags and ANSI in THOR's Visual Config, all you'll
  64. see is a pair of '#'-characters next to the black pieces, ruining the game.
  65.  
  66. Author
  67. ¯¯¯¯¯¯
  68. Troels Walsted Hansen <troelsh@powertech.no>. Contact me through e-mail or
  69. on Ultima Thule for bugreports or requests for features.
  70.  
  71. History
  72. ¯¯¯¯¯¯¯
  73. New in v1.05:
  74. · fixed names of the chess pieces
  75. · userdatabase lookup
  76.  
  77. New in v1.10:
  78. · implemented Pawning and Castling
  79. · corrected starting positions
  80. · switched coordinates, to conform to chess standards
  81.  
  82. New in v1.20:
  83. · enabled editing of file
  84. · implemented Passant
  85. · wrote the docs
  86.  
  87. New in v1.30:
  88. · implemented glorious winner message :-)
  89.